Skip to main content
Glama
SunrisesIllNeverSee

SigRank MCP server

by SunrisesIllNeverSee
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

🏆 SigRank is live: signalaf.com — the leaderboard for how efficiently you use AI, not how much. See your projected rank in 60 seconds at signalaf.com/score. Token counts only. Never your prompts.

The yield cascade + live leaderboard as MCP tools any agent can call.

For all builders, burners and 10xers.

npm version CI CodeQL audit Dependabot license platform live SunrisesIllNeverSee/sigrank-mcp MCP server Smithery

The board

Your operator profile

SigRank leaderboard

SigRank operator profile

Every operator ranked by Υ Yield — the architecture of the cascade, not raw spend

Cascade layer, class, and fingerprint — derived from four token counts

Run sigrank enroll then sigrank submit to get ranked and claim your public profile at signalaf.com.

Quickstart — 3 steps to the board

# 1. Install (pulls ccusage + tokscale + tokendash automatically — no separate installs)
npm install -g sigrank

# 2. Sign in (paste a connect code from signalaf.com → Settings → New key)
sigrank enroll

# 3. Submit your cascade to the board
sigrank submit

# (cautious? see exactly what would be sent — four counts + a signature — sending nothing)
sigrank submit --dry-run

That's it. sigrank reads your local AI session logs on-device, derives your token cascade (Υ Yield, Leverage, Velocity, 10xDEV), and publishes to signalaf.com. No paste, no transcript content — only the four token counts leave your machine.

Or just explore without signing in:

sigrank          # launches the full tabbed TUI (dashboard, compare, board, watch)
npx sigrank board --once    # print the live leaderboard once

Related MCP server: MCP Monitor

Install from GitHub

git clone https://github.com/SunrisesIllNeverSee/sigrank-mcp.git
cd sigrank-mcp
npm install

# Run CLI
node index.mjs                        # TUI (if TTY)
node cli.mjs board --once             # leaderboard one-shot

# Or link globally for `sigrank` command
npm link
sigrank

Repo: SunrisesIllNeverSee/sigrank-mcp Site: signalaf.com npm: sigrank Smithery: smithery.ai/servers/burnmydays/sigrank-mcp Glama: glama.ai/mcp/servers/SunrisesIllNeverSee/sigrank-mcp

Install via Smithery

SigRank is available on Smithery as a stdio MCP bundle — one-click install for Claude Desktop, Cursor, and other MCP clients.

Smithery CLI

# Install Smithery CLI
npm install -g smithery

# Connect to SigRank (downloads the MCPB bundle locally)
smithery mcp add burnmydays/sigrank-mcp --id sigrank

# List available tools
smithery tool list sigrank

# Call a tool
smithery tool call sigrank get_leaderboard '{}'
smithery tool call sigrank rank_paste '{"text": "1000000 500000 50000 800000"}'

Claude Desktop (via Smithery)

  1. Go to smithery.ai/servers/burnmydays/sigrank-mcp

  2. Click Install

  3. Smithery handles the rest — no manual config editing

Commands

⊙ SigRank CLI  v0.14.2

Default (no args)
  sigrank              unified dashboard: cascade + token pillars + board

Commands
  enroll                   sign in: paste a connect code (get one at signalaf.com → Settings)
  submit                   publish your verified runs to the board (sign in first)
  board                    live leaderboard (refreshes every 30s)
  board --window 7d        board for a specific window (7d, 30d, 90d, all)
  board --once             print once and exit
  compare                  raw pillar audit: tokenpull vs ccusage vs token-dash vs tokscale
  compare --platform codex compare for a specific platform
  tui                      full tabbed TUI: Dashboard / Trends / Compare / Board / Watch / Connect
  tui --platform codex     TUI with a different default platform
  watch                    live tune meter — re-reads local logs every 30s
  watch --window 7d        watch a specific window

Options
  --window    7d · 30d · 90d · all  (default: 30d for board, 7d for watch)
  --platform  claude · codex · amp · gemini · opencode · goose · …
  --refresh   poll interval in seconds (default: 30)
  --once      print once and exit (board only)

For AI clients (not typeable)
  In a piped/non-TTY context, sigrank is an MCP stdio server.
  AI clients (Claude, Cursor, …) call its tools automatically — these are
  NOT shell commands. Humans use the commands above.

Examples
  sigrank                        # unified dashboard
  sigrank board                  # live leaderboard
  sigrank compare                # pillar audit (claude)
  sigrank compare --platform codex
  sigrank watch --window 7d --refresh 60
  sigrank board --window all --once

The TUI is the whole app

Launch it and sign in inside it:

npx sigrank

Six tabs. Keys: 1-6 or ← → to switch · R refresh · Q quit.

Tab

Key

Content

Dashboard

1

Cascade table (all platforms × windows + combined) · Υ sparklines · token composition bars · mini board

Trends

2

Every metric across windows — sub-views: You / Platform / Field

Compare

3

4-source pillar audit (tokenpull vs ccusage vs token-dash vs tokscale) · delta % · cascade metrics per source · cache read bar chart

Board

4

Full leaderboard with all fields · [W] cycles window (7d/30d/90d/all)

Watch

5

In-TUI landing panel · [Enter] launches the live watcher (big numbers + pillar bars + Υ trend, auto-refreshes 30s)

Connect

6

Sign in / switch device — paste a connect code from signalaf.com → Settings. Then [S] submits.

Sign in + submit

sigrank enroll          # sign in: paste a connect code (get one at signalaf.com → Settings)
sigrank submit          # publish your verified runs to the board (sign in first)
sigrank submit --dry-run  # inspect the exact signed payload without sending anything

Or do it inside the TUI on the Connect tab (6), then press [S] to submit.

MCP Server mode

When stdout is not a TTY (i.e. piped to an AI client), sigrank starts an MCP stdio server automatically. AI clients (Claude Code, Cursor, Windsurf, etc.) use this path.

Add to .mcp.json or equivalent:

{
  "mcpServers": {
    "sigrank": {
      "command": "npx",
      "args": ["-y", "sigrank"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "sigrank": {
      "command": "sigrank"
    }
  }
}

MCP Tools

Tool

Args

What

rank_paste(text)

{input, output, cacheCreate, cacheRead} JSON or 4 whitespace-delimited numbers

Scores token pillars → Υ Yield / SNR / Leverage / Velocity / 10xDEV / Class + prose narration card

get_leaderboard()

{window?}

Live board from signalaf.com — sorted by Υ Yield

get_operator(codename)

{codename}

One operator's live profile

submit_paste(text, codename)

{text, codename?}

Rank locally then POST to board. Omit codename for preview-only

tokenpull(platform?)

{platform?}

On-device local reader: scans local logs → 4-window cascade. Zero paste, token-only

tokenpull_submit(codename, window?)

{codename?, window?}

tokenpull → publish to board. Omit codename for preview

tokenpull_compare(platform?)

{platform?}

All four sources side-by-side: tokenpull + ccusage + token-dash + tokscale. Returns pillars, cascade metrics, and delta % vs tokenpull per window

rank_windows

{platform?, window?}

Multi-window cascade from local logs

watch_tokenpull

{platform?, interval_s?}

One cascade snapshot per call (interval_s advisory)

submit_verified

{window?, platform?, dry_run?}

THE ranked path: builds + ed25519-signs Schema 1.0 snapshots and POSTs them. platform:'multi' sums all active platforms. dry_run:true returns the exact payload unsent

enroll

{code, device_label?}

Bind this device with a connect code from signalaf.com → Settings

Cascade math

Υ Yield    = (cache_read × output) / input²
SNR        = output / (input + output)
Leverage   = cache_read / input
Velocity   = output / input
10xDEV     = log₁₀(leverage)

Math is in cascade.mjs, dependency-free. Mirrors sigrank-app/lib/ingest/bridge.ts. Canon check: MO§ES (1251211, 11296121, 128196310, 2555179769) → Υ 18436.98.

Token Pillars — sources

The dashboard pulls from multiple sources and shows them side-by-side for verification:

Source

What

Platform

tokenpull

On-device JSONL scanner (canon source)

claude, codex, amp, …

ccusage

ccusage <platform> daily --json CLI (bundled)

claude, codex

token-dashboard

~/.claude/token-dashboard.db SQLite (bundled)

claude only

tokscale

tokscale models --json CLI (bundled, falls back to ~/tokscale_report.json)

claude, codex

Codex input is estimated — Codex logs don't expose true input tokens directly. The formula:

input       = output × ioRatio         (ioRatio derived from Claude ratio, else 2.0)
cacheCreate = uncached − input         (uncached = input_tokens − cached_input_tokens)
cacheRead   = exact (from logs)

Verifier numbers (ccusage/tokscale for codex) show raw uncached input (input_tokens − cached) — a different field than the estimated input above. The discrepancy is expected and explained inline in the dashboard.

Platform adapters

All adapters are token-only (no message content, no cost fields, no credentials).

Platform

Path

Notes

Claude Code

✅ ~/.claude/projects

Native; dedup by (session_id, message_id); subagents included

Codex

✅ ~/.codex/sessions

Estimated input via io_ratio; verified vs ccusage

Amp

✅ ~/.local/share/amp/threads

Full 4-pillar; per-message

Kimi

✅ ~/.kimi/sessions

Full 4-pillar; StatusUpdate lines only

pi-agent

✅ ~/.pi/agent/sessions

Full 4-pillar; per-message JSONL

OpenClaw

✅ ~/.openclaw

Full 4-pillar; per-message JSONL

Droid

✅ ~/.factory/sessions/*.settings.json

Full 4-pillar; thinking→output

Codebuff

✅ ~/.config/manicode

Full 4-pillar; chat-messages.json

Hermes

✅ ~/.hermes/state.db

Full 4-pillar; SQLite; reasoning→output

Kilo

✅ ~/.local/share/kilo/kilo.db

Full 4-pillar; SQLite

Qwen

✅ ~/.qwen/projects

cacheCreate=0 estimated; thought→output

Goose

✅ ~/.local/share/goose/sessions/sessions.db

cacheCreate=cacheRead=0 estimated; SQLite

Gemini CLI

✅ ~/.gemini/tmp

cacheCreate=0 estimated; cache extracted from input field

GitHub Copilot CLI

✅ ~/.copilot/otel

OTel JSONL; requires COPILOT_OTEL_ENABLED=true

OpenCode

⚠️ ~/.local/share/opencode

Raw token counts not persisted in log format

Cursor

🔜

Chat log path TBD

Windsurf

🔜

Session logs at ~/.codeium/windsurf/

estimated=true means one or more pillars are derived, not native. The server re-scores all submitted pillars authoritatively; local preview Υ is indicative only.

Privacy

  • Token-only, always. No message content is ever read, logged, or transmitted — only token counts (input, output, cache_creation, cache_read), message IDs, and timestamps.

  • Local by default. tokenpull reads only ~/.claude/projects (Claude) or ~/.codex (Codex) on your device. Numbers stay on your machine unless you explicitly submit with a codename.

  • Background tooling excluded. Memory plugins, observers, summarizers (e.g. claude-mem, mem0, observer-sessions) are filtered from both Claude and Codex reads. subagents/ are kept — they represent real operator work.

  • Board reads are anonymous. No account needed to browse, compare, or watch.

  • Ranked submissions are signed, not trusted. sigrank submit requires a one-time enroll (device-bound ed25519 key — the private key never leaves your machine). Verify what's sent with sigrank submit --dry-run: the payload is four token counts, ratios, and a signature.

Env vars

Var

Default

Description

SIGRANK_API_BASE

https://signalaf.com

Override the board host

SIGRANK_FETCH_TIMEOUT

10000

Board API fetch timeout (ms)

Dev / test

node test.mjs          # 29 unit tests (no network, no fs writes)
node index.mjs         # stdio MCP server directly (pipe to MCP client)

Tests verify (29 assertions):

  • rank_paste canon: MO§ES (1251211, 11296121, 128196310, 2555179769) → Υ 18436.98 · TRANSMITTER

  • submit_paste preview (no codename) + POST shape (injected fetch, no live writes)

  • tokenpull dedup, window slicing, 4-window pillars (mock adapter)

  • tokenpull_submit all 4 windows POST, sha256 hash, ddmmyy stamp

  • tokenpullCodex io_ratio conversion per-window

  • Adapter registry (15 platforms) + per-adapter shape contracts

  • rank_windows 4-window paste scoring, partial input, no-network

  • watch_tokenpull cascade snapshot, interval_s, TODO(AUTH.WIRE) stub

  • Hardening: div-by-zero guards, parsePillars warnings, fetch timeout, EXCLUDE_TOOLING regex, narrate safety

File map

File

Responsibility

index.mjs

Entry point — TTY detection, routes to CLI or MCP server

cli.mjs

CLI commands: board, compare, watch, enroll, submit, help

tui.mjs

Full tabbed TUI: Dashboard / Trends / Compare / Board / Watch / Connect

cascade.mjs

Pure cascade math (Υ, SNR, leverage, velocity, 10xDEV, class)

tokenpull.mjs

On-device log scanner — Claude, Codex, multi-platform

adapters.mjs

Platform adapter registry (15+ platforms)

tools.mjs

MCP tool table + dispatcher

connect.mjs

Connect-code enrollment + device identity

keystore.mjs

Local key management (paste-keys, not API keys)

submit.mjs

Verified submit flow (signs + POSTs to board)

sign.mjs

Schema 1.0 signing (X-Agent-Signature)

narrate.mjs

Deterministic prose narration card

test.mjs

Unit tests (no external deps)

Install Server
A
license - permissive license
A
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
1dRelease cycle
3Releases (12mo)
Commit activity

Resources

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/SunrisesIllNeverSee/sigrank-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server